home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / DA / D / dBASE Toolbox.cpt / ToolBox Docs < prev   
Encoding:
Text File  |  1988-01-26  |  5.2 KB  |  112 lines  |  [TEXT/ACA␤]
  1. dBASE Toolbox Documentation (version 1.0)
  2. 11/2/87  by Kent Irwin
  3. ------------------------------
  4.  
  5. dBASE Toolbox is a desk accessory designed to facilitate the creation of
  6. dBASE Mac DIALOG procedures.  Using an object-oriented drawing surface like
  7. MacDraw, you can create, drag, size, and edit dialog items quickly and easily.
  8. When it looks the way you want, the Toolbox will write the DIALOG command
  9. for you, and you can simply Copy it to the clipboard and Paste it into
  10. a dBASE Mac procedure.  You can also paste an existing DIALOG procedure into
  11. the Toolbox window, and then view or edit it graphically.
  12.  
  13. How to use it
  14. -------------
  15. Begin, of course, by installing dBASE Toolbox with Font/DA Mover.  Normally
  16. you will want to install it into your System file.  If you would like dBASE
  17. Toolbox to appear only in dBASE Mac, the way Picture This… does, follow
  18. these steps:
  19.  
  20.     1. From the Finder, double-click the dBASE ToolBox DA icon.  This will
  21.             open Font/DA Mover, with dBASE Toolbox in the left box.
  22.     2. Option-click the right Open… button, and select the dBASE Mac application
  23.             in the selector box.
  24.     3. Click on dBASE Toolbox in the left box, then click the >> Copy >> button.
  25.     4. Quit Font/DA Mover.
  26.  
  27. When you're finished, dBASE Toolbox will appear in the Apple menu only when
  28. you are in dBASE Mac.
  29.  
  30. When you open the DA, you will see a window.  The interior of this window
  31. represents the dialog box you are creating/editing.  By dragging and sizing
  32. the window, you determine the size and position of the dialog that will
  33. be created for dBASE Mac.
  34.  
  35. The Toolbox menu contains choices for creating the various dialog items
  36. that are availble in dBASE.  Once you create items (objects), the following
  37. actions may be taken:
  38.  
  39.     Drag - drag object by clicking anywhere inside
  40.     Size - size an object by clicking in the 'handle' (lower-right corner).
  41.         An object's handle only appears when it is selected.
  42.     Double-click - brings up an info dialog where you can edit the
  43.             object's label or delete the object.
  44.     Return or Enter - brings up info dialog for selected object.
  45.     Tab - selects next object.
  46.     Shift-Tab - selects previous object.
  47.     BackSpace - deletes selected object.
  48.     Clear (Edit menu) - deletes ALL objects (you get to confirm).
  49.  
  50. There are two modes for the window: Dialog and Procedure.  When you first
  51. open the Toolbox, you are in Dialog mode.  This is the mode where you
  52. graphically create/edit a dialog.  Cut, Copy, and Paste have no effect in
  53. this mode.  When you want to see the dBASE procedure for your dialog,
  54. choose Show Procedure from the menu.  This puts you into Procedure mode,
  55. where you can see the text of the dBASE procedure.  Cut or Copy will
  56. place a copy of the text into the Clipboard.  Paste will place the contents
  57. of the clipboard into the Toolbox window.  DON'T paste entire dBASE procedures
  58. into the Toolbox, just paste in the DIALOG portion.  No editing is allowed
  59. in the Procedure window.  If there is a DIALOG procedure in the Procedure
  60. window, selecting Show Dialog from the menu will convert it to graphic form
  61. in the Dialog mode.
  62.  
  63. In Dialog mode there are no scroll bars, since the window represents the
  64. limits of your dialog box.  Instead, you get controls called Limit Lines
  65. that look like little pull-rings.  Limit Lines allow you to set margins
  66. which will restrict the moving/sizing of objects in the window, and also
  67. help align objects vertically or horizontally.  Just grab and drag the
  68. little pull-rings to set a Limit Line.  There are four Limit Lines; top,
  69. left, bottom, and right.  Once you set a limit line, it acts like the edge
  70. of the window, and won't let you drag or size anything past it.  Suppose you
  71. want to line up several radio buttons so their left ends line up vertically.
  72. Just drag the left Limit Line to where you want them to line up, then drag
  73. each radiobutton up against the limit.  To reset all the Limit Lines back to
  74. the window edges, just click in the window's Grow box.
  75.  
  76. About RadioButtons
  77. ------------------
  78. Radio button objects have an additional field displayed in their edit
  79. dialog; "Set".  This field is a number which determines what set the
  80. individual button belongs to.  Radio buttons are grouped into sets.  When
  81. the dialog is used in dBASE Mac, only one button in a set may be selected
  82. at any time.
  83.  
  84. About FixedGraphics
  85. -------------------
  86. Fixed graphic items in dBASE Mac come from fields (in files or Globals).
  87. The Toolbox always puts "<Fieldname>" into the procedures it writes for
  88. fixed graphic items.  You must replace this with a proper fieldname
  89. after you paste the procedure into dBASE.  The edit dialog for fixed graphic
  90. items does not show the label edit box for this reason.
  91.  
  92. About Pushbuttons
  93. -----------------
  94. The first button you create will have a thicker border than any buttons you
  95. create later.  This is the 'default' button, and is the button that is
  96. activated when a user presses Return or Enter in the dialog.  Note that this
  97. is for convenience in this DA only...dBASE Mac dialogs don't highlight the
  98. default button like this! 
  99.  
  100. Limitations
  101. -----------
  102. Max. number of objects = 50
  103. Max. radio sets = 10
  104. Max. label size = 255 chars.
  105.  
  106. I hope this utility is useful to somebody...it is to me.  Any comments
  107. will be welcome...
  108.  
  109. Kent Irwin
  110. Ashton-Tate Support
  111.  
  112. Ashton-Tate BBS (213-538-6196) -- (a free, multi-user BBS)  Username: "Kent"